home *** CD-ROM | disk | FTP | other *** search
/ Acorn Risc Technologies StrongARM CD-ROM / Acorn Risc Technologies StrongARM CD-ROM.iso / ftp / documents / appnotes / 046_060 / 049c / Text
Encoding:
Text File  |  1993-08-02  |  40.0 KB  |  968 lines

  1. 5th August 1992
  2. -----------------------------------------------------------------------------
  3. Support Group Application Note 
  4. Number: 049
  5. Issue: 1 
  6. Author:
  7. -----------------------------------------------------------------------------
  8.  
  9. Master 512:  Applications Compatibility and Software List
  10.  
  11. -----------------------------------------------------------------------------
  12. Applicable Hardware: BBC Master 512
  13.  
  14. Related Application Notes:
  15.  
  16.  
  17. -----------------------------------------------------------------------------
  18. Copyright (C) Acorn Computers Limited 1992
  19.  
  20. Every effort has been made to ensure that the information in this leaflet is 
  21. true and correct at the time of printing. However, the products described in
  22. this leaflet are subject to continuous development and improvements and
  23. Acorn Computers Limited reserves the right to change its specifications at
  24. any time. Acorn Computers Limited cannot accept liability for any loss or
  25. damage arising from the use of any information or particulars in this
  26. leaflet. ACORN, ECONET and ARCHIMEDES are trademarks of Acorn Computers
  27. Limited.
  28. -----------------------------------------------------------------------------
  29. Support Group
  30. Acorn Computers Limited
  31. Acorn House
  32. Vision Park
  33. Histon
  34. Cambridge       CB4 4AE
  35. -----------------------------------------------------------------------------
  36.  
  37.  
  38.  
  39. Introduction
  40.  
  41. The operating system supplied with the Master 512 is DOS plus by Digital
  42. Research. This application note explains the main features available to the
  43. user and the applications programmer, and the main causes of any
  44. incompatibility of applications on the Master 512. It also provides a list
  45. of tested packages which have been found to work and other useful
  46. information such as contacts.
  47.  
  48.  
  49. Memory size
  50.  
  51. PC Dos 2.1 takes only about 64k of space from the user when running on an
  52. IBM PC. Dos+ takes about 154k of space away from the user when running on a
  53. Master 512. Hence the usable space on a Master 512 is about 90k less than
  54. the usable space on a 512k IBM PC. Packages specifying 512k or 640k may
  55. therefore have problems with memory limitations. The version of GEM on the
  56. Master may also limit the use of some applications, as the desktop takes
  57. away a further 333k. This means that packages such as GEMWrite will only
  58. have about 25k free for text files. This can be over come with a memory
  59. expansion board such as the Solidisk PC+.
  60.  
  61.  
  62. System Calls
  63.  
  64. DOS+ 1.2 is system call compatible with PC-DOS 2.1 and MS-DOS 2.1. This
  65. means that if a programmer looks at the documentation for PC-DOS 2.1 (for
  66. instance) then all of the system calls documented therein are available to
  67. the programmer when running under DOS+ and will behave as described in the
  68. documentation. DOS plus is designed to be compatible with MS-DOS 2.1 and
  69. CP/M(86). Compatibility is achieved at three levels, these are:
  70.  
  71. (1) User Commands
  72. (2) Operating System Calls
  73. (3) The ROM BIOS(ROS) function calls
  74.  
  75. An application program which interacts with the rest of the world only via
  76. the official system calls of MS-DOS 2.1 will run correctly on the Master
  77. 512. MS-DOS 2.1 applications frequently use other methods of communicating
  78. with the rest of the system, these are explained in subsequent sections.
  79.  
  80. Some of the latest GEM packages expect the latest version of GEM, and they
  81. make use of the new calls it provides. This version of GEM has not been
  82. ported to the Master. These packages may therefore not run correctly under
  83. the Master version of GEM.
  84.  
  85. It is possible to load the MS-DOS 2.1 COMMAND.COM file or reload the DOS+
  86. COMMAND.COM file under the Master DOS+. This does take more memory but
  87. improves compatibility with certain packages, such as Turbo Pascal 4.0 which
  88. works correctly with a second COMMAND.COM file loaded. This may be worth
  89. trying if your application loads but does not run correctly. To re-load
  90. COMMAND.COM just type COMMAND RETURN at the A> prompt.
  91.  
  92.  
  93. Direct Hardware Access
  94.  
  95. Some applications written for the PC exhibit this behaviour and will read or
  96. write directly to registers known to be accessible on the PC. With the
  97. exception of the colour graphics adapter's screen memory, the Master 512
  98. cannot intercept any of these accesses and in many cases this can prevent an
  99. application from running, or running properly. Hardware affected includes:-
  100.  
  101.         The video controller
  102.  
  103. There is a video controller chip on the board of the IBM PC (usually the
  104. 6845 as used in the Master), which some applications write to directly. The
  105. most common reason for this is to change the appearance of the cursor or to
  106. change the display mode. Neither of these cases are catastrophic. In the
  107. case of changing the cursor it will simply remain unchanged and the on
  108. screen appearance will not be as the application writer intended. The case
  109. of accessing the video controller to change the display mode is rare because
  110. there is a legal ROS function to do this. If it does happen however, it is
  111. usually done at the start of the program and the user must determine the
  112. mode which the application is trying to change to (by trial and error
  113. probably) and set the system up for this screen mode before starting up the
  114. application. The screen mode can be changed using the PCscreen utility
  115. supplied on the DOS boot disc.
  116.  
  117.         The timers
  118.  
  119. There are a number of timers on the IBM PC board and some applications make
  120. use of these. The effect of not having these timers on the Master 512 really
  121. depends on what the application was trying to do. In some cases the
  122. application might go into an infinite loop, in other cases it might simply
  123. return the wrong results for timings.
  124.  
  125.         Sound
  126.  
  127. There are no legal methods of producing anything more complicated than a
  128. standard bell (control G) sound on the IBM PC without accessing the hardware
  129. directly. A program which attempts to produce complex sounds will simply run
  130. silently on the Master 512. There is a sample program on disc four, called
  131. SIREN. This is a machine code program written using MASM, which demonstrates
  132. how you can produce sound from within programs running on the 512, using the
  133. calls to the Master 128 MOS provided on the Master 512.
  134.  
  135.         The disc controller
  136.  
  137. This can cause the most severe problems, as the Master uses a 1770 disc
  138. controller rather than the NEC disc controller. Some of the more
  139. sophisticated disc protection mechanisms access the disc controller directly
  140. to perform their protection. The type of protection which causes this
  141. problem is called key disc protection whereby the user is required to always
  142. have the original master disc inserted in floppy drive A (even when running
  143. the package off of a hard disc). If an application uses a protection
  144. mechanism which accesses the disc controller directly then it will not run
  145. on a Master 512, as the disc controller in the Master is the WD 1772 and not
  146. the NEC used in the PC. The situation is not as bad as it might seem:-
  147.  
  148. Not all protection mechanisms (even keydisc protection) work by accessing
  149. the disc controller directly, some work legally through the operation
  150. system.
  151.  
  152. Some vendors of copy protected packages will supply a non copy protected
  153. disc once the user has purchased the normal copy protected product.
  154.  
  155. There is some move away from copy protection in the market place, as most
  156. users are now moving to hard discs where keydisc protection can cause
  157. problems.
  158.  
  159.  
  160.         Keyboard Emulation
  161.  
  162. The PC Keyboard driver returns a more complex value than just a single byte
  163. to represent the key pressed. The Master 512 keyboard driver is designed to
  164. return the same values as the PC when any given key or combination of keys
  165. are pressed, hence to an application program the keyboard will look
  166. identical to that of a PC. The only limitations are that holding down the
  167. copy key and typing the ASCII value of the key on the num pad will not work
  168. before DOS+ version 2.1. The major problem is with those packages that
  169. directly access the keyboard driver to read certain keys. On DOS+ 1.2 the
  170. 7ALT1 key does not work correctly with a number of packages, however DOS+
  171. 2.1 has been modified to deal with this type of behaviour as far as
  172. possible. As it is not possible to redefine any of the keys, DOS+ will
  173. ignore a KEYBUK.EXE file.
  174.  
  175.         IBM keys emulated using the numeric keypad
  176.  
  177. These keys are available for use on the Master 128 by using the numeric
  178. keypad. None except for 7ALT1 are available for people using a BBC B or B+
  179. machine with a universal second processor adapter, as the B and B+ do not
  180. have the numeric keypad, and the keys provided on the Master numeric keypad
  181. cannot be redefined as standard, however it is possible to write a program
  182. that will allow the use of the number keys in conjunction with the shift
  183. lock key to emulate the keypad. This utility is available on the DOS+ user
  184. group disc, and with the Dab hand reference manual. As standard you may have
  185. problems when running packages such as Framework II, which make use of these
  186. keys. They are as follows :-
  187.  
  188.  
  189. IBM keyboard    Equivalent Master 128 key
  190.  
  191. ALT             COPY
  192. Rubout          Delete on main keyboard
  193. End             1 on num pad
  194. Down arrow      2 on num pad
  195. Page down       3 on num pad
  196. Left arrow      4 on num pad
  197. Right arrow     6 on num pad
  198. Home            7 on num pad
  199. Up arrow        8 on num pad
  200. Page up         9 on num pad
  201. INS             0 on num pad
  202. Scroll lock     # on num pad
  203. Break           # on num pad
  204. PrtSc           * on num pad
  205. Num lock        / on num pad
  206. Del             Delete on num pad
  207.  
  208. Although these keys are provided and return the same value as their PC
  209. equivalents, this does not imply that the same function will be performed.
  210. What is done with the returned value is up to the application. For instance,
  211. pressing the 7PrtSc1 key at command level on a PC initiates a screen dump.
  212. Although pressing 7*1 on the Master num pad will generate the same character
  213. code, it will not initiate a screen dump, because this is not supported by
  214. DOS+.
  215.  
  216.         Function keys
  217.  
  218. The function keys on the Master 128 Keyboard are predefined from within
  219. DOS+, and cannot be redefined using a KEYBUK.EXE file as on the PC. They can
  220. however be redifined to the IBM settings by typing 'COMMAND' after loading
  221. DOS+. The Master settings can be recovered by pressing CTRL+C. Their
  222. settings are :- 
  223.  
  224. Key     M512 Setting    IBM setting  
  225. f0      GEM <cr>  
  226. f1      HELP <cr>       Copies 1 char from source line to command line 
  227. f2      SDIR            Copies all chars upto specified char from src 
  228.                                 line to comnd line.  
  229. f3      SHOW            Copies all remaining chars in source line to 
  230.                                 command line.  
  231. f4      SET             Skips over chars in source line up to
  232.                                 specified char.  
  233. f5      COPY            Copies command line as new source line, but does
  234.                         not execute it.  
  235. f6      REN 
  236. f7      DEL 
  237. f8      TYPE 
  238. f9      CD \
  239.  
  240.         VDU codes
  241.  
  242. The IBM PC uses a particular sub-set of the ANSI standard, with a few
  243. extensions of its own. Our DOS+ supports most of the ANSI codes that the IBM
  244. uses. It doesn't support some things such as being able to reprogram the
  245. keyboard (this is an IBM extension and not part of the ANSI standard). We
  246. are also unable to support all of the colours available with a CGA graphics
  247. card, as the mode 0 used in the Master is only a 2 colour mode.
  248.  
  249. There was a problem with the ANSI codes on the first release of DOS+. They
  250. were quite happy when legal values were given, but did strange things when
  251. illegal values were given. This has been corrected in the release 2 and 3 of
  252. DOS+. The main ANSI codes we support are:-
  253.  
  254. VDU code                Effect
  255.  
  256.  
  257. Esc A or Esc [ nA       Cursor up
  258. Esc B or Esc [ nB       Cursor down
  259. Esc C or Esc [ nC       Cursor right
  260. Esc D or Esc [ nD       Cursor left
  261. Esc E or Esc [ 2 J      Clear screen
  262. Esc e                   Cursor on
  263. Esc f                   Cursor off
  264. Esc [ n;nF              Cursor position (column/row)
  265. Esc [ n;nH              Cursor position (row/column)
  266. Esc [ K                 Erase to end of line
  267. Esc p                   Inverse video
  268. Esc q                   Normal video
  269. Esc [ r                 Restore cursor position
  270. Esc [ s                 Save cursor position
  271. Esc [ =nh               Set IBM screen mode 1
  272.  
  273. KEY: Where 'n' appears you should substitute an ASCII value. Esc means the
  274. escape character, usually ASCII 27. An example to move the cursor down 12
  275. lines in Microsoft BASIC is:- PRINT CHR$(27);"[12B"; 
  276.  
  277.  
  278. Undocumented System Calls
  279.  
  280. A few MS-DOS applications make undocumented calls to the operating system.
  281. This sort of behaviour is fairly rare, but does include some Microsoft
  282. packages. Since the behaviour of these calls is undocumented, they cannot be
  283. and are not supported on the Master 512 under DOS+. Some new packages also
  284. make use of new calls in MS-DOS 3.2/3.3 which are not present in MS-DOS 2.1
  285. and therefore not present in DOS+. Packages using these calls may therefore
  286. run incorrectly.
  287.  
  288.  
  289. Open files
  290.  
  291. DOS+ 1.2 has a limit of 20 files open at one time, this is extended on 2.1.
  292. Any applications that require more than the allowed number of files open at
  293. one time may not work correctly. The MS-DOS CONFIG.SYS and ANSI.SYS files
  294. are also not recognised by DOS+ as they have no effect on the default
  295. settings for files, buffers etc.
  296.  
  297.  
  298. Screen Emulation
  299.  
  300. The ROS routines for reading and writing PC screen memory are very slow on
  301. the IBM PC and so most high performance applications resort to accessing the
  302. screen memory directly. The Master 512 system software provides emulation
  303. for the IBM CGA (colour graphics adapter). It cannot emulate EGA (Enhanced
  304. graphics adapter) or Hercules as these are beyond the hardware capability of
  305. the machine. CGA is emulated in the following way:
  306.  
  307. Applications are allowed to read or write to memory between addresses hex
  308. B8000 and hex BBFFF, this is where they would expect to find the screen
  309. memory on an IBM PC with a CGA adapter. Every 100 milliseconds a special
  310. interrupt task is activated which examines the screen and by comparing it
  311. with a copy made the last time that the interrupt task was invoked, checks
  312. to see if any changes have been made. If any bytes have been changed then
  313. the interrupt program calculates which pixels have been altered and passes
  314. the information across the tube, mapping them into a 20k mode 0 screen for
  315. display.
  316.  
  317. (Draw file 'MemMap')
  318.  
  319. This is only a general memory map. If you have the Solidisk PC+, then the
  320. memory map changes, as DOS+ relocates itself higher up in the memory map, to
  321. give a large contiguous block of user memory.
  322.  
  323. The screen emulation works very well for graphics modes, there can however
  324. be a slight problem with character modes. On the PC it is possible to
  325. display 40x25 or 80x25 characters in 16 colours. These screens are emulated
  326. using the Master 128 mode 0, so only two colours are available. The result
  327. is that certain packages such as the Sage range, which make use of the
  328. colours to display menus etc will not look the same as on the IBM. The
  329. screen emulation caters for those applications which access the screen
  330. directly, so these programs will not fail to work on the Master because of
  331. this. Applications should therefore be set up to use a CGA adapter, and
  332. where possible a mono monitor as well.
  333.  
  334.  
  335. Media Compatibility
  336.  
  337. The disc drivers in DOS+ will recognise discs in a number of different
  338. formats and will automatically detect the format size of a PC disc. This
  339. means that it is possible to have different format discs in the top and
  340. bottom drives. The main format used by the Master 512 is the 800k format so
  341. this is checked for first. The DOS then works its way down the list until it
  342. has checked all the formats available. If the disc is not recognised an
  343. error message will be generated. The only problem occurs with formatting the
  344. IBM 360k format discs. Because of the speed difference between PC drives and
  345. some drives used on the Master the inter sector gap may be to small for the
  346. disc to be read on a PC, if it was formatted on the Master. However if you
  347. format the disc on the PC you should be able to use it with both the PC and
  348. the Master.
  349.  
  350.  
  351. DOS disc formats supported :-
  352.  
  353. TYPE                    SIZE    BYTES xSECTORS xTRACKS EQUIV BBC FORMAT  
  354.  
  355. Acorn DOS format        800k    1024    x 5     x 160   800k ADFS
  356. Tandy DOS format        720k    512     x 9     x 160   N/A
  357. Olivetti DOS format     720k    512     x 9     x 160
  358. IBM DOS format          720k    512     x 9     x 160
  359. Nimbus DOS format       720k    512     x 9     x 160
  360. Altos CP/M format       720k    512     x 9     x 160
  361. Acorn bootable DOS      640k    256     x 16    x 160   640k ADFS
  362. Acorn Z80 CP/M format   400k    256     x 10    x 160   400k DFS
  363. IBM DOS format          360k    512     x 9     x 80
  364. IBM CP/M format         320k    512     x 8     x 80
  365.  
  366.  
  367. DABS press produce a utility disc for the Master 512, containing a disc
  368. editor that will work on all of the formats supported.
  369.  
  370.  
  371. IBM Rom BIOS Calls
  372.  
  373. The rom on the IBM PC contains some documented entry points which can be
  374. called from application programs. Many of these so called ROS functions are
  375. supported on the Master 512 in the XIOS and are essential to support
  376. application programs that have been written specifically for the IBM
  377. machines. The ROS entry points are used by some applications for low level
  378. control of various pieces of IBM hardware, for example: reading and writing
  379. the screen, keyboard control, disc control.
  380.  
  381. There are some cases where it is not possible to fully support the
  382. functionality of certain ROS calls. For example the call relating to the
  383. control of the serial interfaces on a PC make certain assumptions about the
  384. underlying hardware, (e.g. that the hardware can provide a carrier detect
  385. signal, such a signal is not available on the Master hardware). As a general
  386. rule however, the vast majority of ROS functions are supported and it is
  387. only applications which attempt complicated use of the serial lines which
  388. will fail here. This includes most comms packages.
  389.  
  390.  
  391. Mouse Drivers
  392.  
  393. Those programs that will run from the GEM desktop will be able to use the
  394. supplied mouse, however those programs that are able to use the MS mouse
  395. will not be able to use the supplied mouse. This is because there is no
  396. Microsoft compatible mouse driver supplied. The Microsoft Mouse does not
  397. work correctly with the Master due to hardware and software limitations. The
  398. MOUSE.COM file that is supplied with a number of packages will therefore not
  399. be recognised by DOS+. The source of the mouse driver is available to anyone
  400. who wants to write their own driver. There will also be a mouse driver with
  401. the Dab hand reference guide.
  402.  
  403. DOS+ Errors
  404.  
  405. With some packages or parts of packages you may get errors such as "Cannot
  406. Load Program", "Illegal Opcode", "Invalid Opcode error" or "Undefined
  407. Opcode". Usually this means that this package or part of package will not
  408. work under DOS+, as it is accessing something directly or using unsupported
  409. calls, alternatively it may be too large. The list of registers that are
  410. usually displayed after such an error is generated are just there as a
  411. debugging aid, and provide no useful information.
  412.  
  413.  
  414. Maths co-processor
  415.  
  416. On most of the IBM machines and their clones, you have the facility to add a
  417. maths co-processor, which makes floating point operations much faster.
  418. Although the bus for a co-processor is supported on the 8086, 80286 and
  419. 80386, it is not supported on the 80186. As a result you cannot use a maths
  420. co-processor with the 80186. This will only mean that packages such as Turbo
  421. Pascal, which can make use of a floating point processor such as the 8087 or
  422. 80387, will not be able to be used to their full potential on the Master
  423. 512.
  424.  
  425.  
  426. MS-DOS
  427.  
  428. The hardware that is used for the Master 512 has been designed to offer a
  429. high level of compatibility with the hardware used in a PC. However there
  430. are a number of hardware restrictions. If MS-DOS had been used in place of
  431. DOS+ it would not have been any more compatible. This is because the
  432. restrictions are not due to the operating system, but due to the emulation
  433. of the PC enviroment. To use DOS+ properly (or even MS-DOS) on the Master
  434. 512 would require additional hardware which would have made the co-processor
  435. very expensive and unviable as a product. This hardware could have been
  436. emulated in software, but the overhead would have made the Master 512 slower
  437. than an original IBM PC. It was therefore decided to use DOS+ and produce a
  438. board that was very good value for money.
  439.  
  440. DOS+ 2.1 will be the last operating system version that Acorn will be
  441. offering on the Master 512, but this does not mean that third parties will
  442. not be offering other operating systems.
  443.  
  444.  
  445. DOS Plus Differences
  446.  
  447. The second release of DOS+ 1.2 has most of the bugs in the first version
  448. fixed, it also had a new version of GEM which uses 16k less memory. The
  449. following utilities have also been updated:-
  450.  
  451. GETFILE and PUTFILE now work with ADFS, ANFS and DFS. HDISK gives more
  452. partition sizes for the hard disc.
  453.  
  454. Four new commands have been added, these are:-
  455. Label.  Allows you to title DOS+ format discs.
  456. SKS.    This allows Sidekick and other memory resident programs to run under DOS+. 
  457. Edbin.  This is a binary file editor and is documented separately.
  458. Move.   This allows the transfer of files from any filing system to any
  459.         other filing system,  this command is far more flexible than Getfile
  460.         and putfile. Again it is documented separately. 
  461.  
  462. A large number of the other utilities have been updated.
  463.  
  464.  
  465. The third issue of DOS+ is DOS+ 2.1. This is a new version, which has a
  466. number of additional upgrades as well as all the known bugs fixed. DOS+ 2.1
  467. can use installable device drivers, as long as the FIDDLOAD.COM file is on
  468. the disc.
  469.  
  470. To activate the Sidekick loader, you just type 'sks' with the boot disc in
  471. the drive before you load SideKick. LABEL is used in the form LABEL [name of
  472. disc], where the name of disc is the title you wish to have on that disc.
  473. The title can be changed as often as you like, but you must have the boot
  474. disc or a disc containing the Label utility to use this command.
  475.  
  476. You can now also use SHIFT+ALT+ASCII number to produce characters, although
  477. it will not display characters above 127. DOS+ 2.1 also allows more open
  478. files at one time.
  479.  
  480. If you have been using the Microsoft Flight Simulator under DOS+1.2, and
  481. have upgraded to DOS+ 2.1, you will find that the Flight Simulator will no
  482. longer work. This is due to a modification that was necessary on DOS+ to
  483. allow the use of memory expansion boards.
  484.  
  485.  
  486. Important
  487.  
  488. It would appear that a number of software packages are now being updated
  489. either just to improve them or to take advantage of new facilities offered
  490. by the latest PC clones and MS-DOS 3.2 / 3.3. Some of these new versions use
  491. calls, or facilities not used by the older versions. In some cases packages
  492. which worked correctly on the Master 512 and which appear on the following
  493. list, will not work correctly in their latest version. Please make sure that
  494. you test a package before you buy it, or arrange a refund option if that
  495. package has recently been updated. We can accept no responsibility for
  496. packages which appear on the following list, but are found not to work on
  497. the master 512.
  498.  
  499. For example:- Versions of Sidekick prior to and including 1.50 work,
  500. versions after 1.50 do not work.
  501.  
  502.  
  503. USING SERIAL PRINTERS
  504.  
  505. If you wish to use a serial printer with your Master 512 you need to follow
  506. either of the following procedures depending upon which version of DOS+ you
  507. have.
  508.  
  509. Serial Printer with DOS+ 1.2
  510.  
  511. Boot up DOS+ on your machine. Leave disc 1 (DOS+ BOOT DISC) in drive A,
  512. unless you are booting from a Winchester. From the A> (C>) prompt type the
  513. following:-
  514.  
  515.  device auxout:=null <RETURN>
  516.  device lst:=aux0 <RETURN>
  517.  device aux0[speed=(tr,rx)] <RETURN>
  518.  
  519. Device is a program on disc 1 (DOS+ BOOT DISC).
  520. tx = transmit speed e.g. 300, 1200, 9600 baud.
  521. rx = receive speed e.g. 300, 1200,9600 baud.
  522.  
  523. Consult your printer manual to find the baud rate of your printer. If, for
  524. example, your printer is running at 1200 baud, then tx and rx will both be
  525. set to 1200. If your printer has the option of running at a number of baud
  526. rates then set it for the fastest rate it will work at up to 9600 baud.
  527.  
  528. Serial Printer with DOS+ 2.1
  529.  
  530. Boot up DOS+ on your machine. Leave disc 1 (DOS+ BOOT DISC) in drive A,
  531. unless you are booting from a Winchester. From the A> (C>) prompt type the
  532. following:-
  533.  
  534.  device auxout:=null 7RETURN1
  535.  device prn:=aux0[speed=(tx,rx)] 7RETURN1
  536.  
  537. Device is a program on disc 1 (DOS+ BOOT DISC).
  538. tx = transmit speed e.g. 300, 1200, 9600 baud.
  539. rx = receive speed e.g. 300, 1200,9600 baud.
  540.  
  541. Consult your printer manual to find the baud rate of your printer. If, for
  542. example, your printer is running at 1200 baud, then tx and rx will both be
  543. set to 1200. If your printer has the option of running at a number of baud
  544. rates then set it for the fastest rate it will work at up to 9600 baud.
  545.  
  546. USING ..CMD IN GEM WRITE
  547.  
  548. ..CMD is an inbuilt command in GEM Write that allows you to send special
  549. control characters to the printer.
  550.  
  551. GEM Write can only use the underline, bold and italic styles that most dot
  552. matrix and daisy wheel printers support as standard, but most modern dot
  553. matrix printers also support a number of other features such as superscript,
  554. nth inch line spacing, graphics characters etc. If, for example, you wish to
  555. use condensed printing on the Epson FX-80, then you can do this with GEM
  556. Write using the ..CMD embedded command. ..CMD is one of a number of embedded
  557. commands that GEM Write supports; it allows you to send control codes
  558. directly to the printer.
  559.  
  560.  
  561. So to get your condensed print, you would send the control codes to turn
  562. condensed on and off directly to the printer. For example, with the FX-80
  563. you would put ..CMD<O on the left margin of your text to turn condensed on.
  564. Then, after the text you wish to be in condensed print, you put ..CMD<P on
  565. the left margin, to turn condensed off. The character '<' is produced by
  566. pressing the ESCAPE key. You must ensure that there are NO spaces in the
  567. command.
  568.  
  569. The other thing to note is that your printer may be case sensitive, i.e.
  570. ..CMD<h will produce a different effect to ..CMD<H. If your printer manual
  571. gives the control codes for your printer as ASCII values, i.e. 27,35 or Esc,
  572. 65 then you should translate the ASCII value into its character equivalent.
  573. For example Esc, 65 would be entered as ..CMD<A. If you put in the number
  574. then the ASCII codes of the numbers will be sent to the printer so if you
  575. put ..CMD<65 in the text, then 54,53 will be sent to the printer. This
  576. command is very useful, and can be used to send commands to most printers.
  577. You will need to consult your printer manual to find the correct codes for
  578. the different highlights that your printer supports.
  579.  
  580. SINGLE LINE FEED IN GEM WRITE
  581.  
  582. One problem that comes up frequently is getting double spacing between lines
  583. of printed text from GEM Write or getting a form feed between pages. This is
  584. caused by GEM Write sending a carriage return (CR) and a line feed (LF) to
  585. the printer or by GEM Write being set up to send a form feed.The easiest
  586. method to overcome this with most printers is to set the 'CR from host' DIP
  587. switch to off, so that the printer ignores carriage returns sent from the
  588. host computer.
  589.  
  590. If however the printer does not have such DIP switches, or other packages
  591. that are used in the BBC mode require this DIP switch to be on, then you can
  592. tell GEM Write not to send carriage returns. This is done as follows:- 
  593.  Boot DOS+ and GEM as normal, then load GEM Write, but do not load a file.
  594.  
  595. The following only needs to be done once, the settings will then be saved
  596. and used automatically.
  597.  
  598. Move the pointer to FILE on the menu bar and move down to TO OUTPUT. Select
  599. TO OUTPUT, which will give you a menu box labelled Create .OUT file. Select
  600. Start on this menu box. This will give you the output screen with another
  601. menu box labelled START OUTPUT. Select Cancel, which will leave you with the
  602. OUTPUT screen.
  603.  
  604. Move the mouse pointer over OPTIONS on the top menu bar, then move down the
  605. menu to Printer and select this. You should now get a large selection box,
  606. labelled PRINTER OPTIONS.
  607.  
  608. Make sure that the options are set up as follows:-
  609.  
  610.  Scale:                 Best fit
  611.  Initial Form Feed:     NO
  612.  Final Form Feed:       NO
  613.  Horizontal Justif:     Center
  614.  Vertical Justif:       Center
  615.  Print in background:   NO
  616.  
  617. Then select OK.
  618.  
  619. Reselect the options menu, but move down to MAKE DEFAULT and select this.
  620. Your new options will then be saved. You can now go back into GEM Write by
  621. selecting QUIT from the bottom of the FILE menu.
  622.  
  623. When you come to print out a letter that you have written or loaded, you
  624. should do the following before going to the output stage:-
  625.  
  626. Move the pointer onto PAGE on the top menu bar. Then move down to FORMAT and
  627. select this. You will get a selection box titled PAGE FORMAT OUTPUT. Change
  628. the settings so that it is set up as follows:
  629.  
  630.  
  631.  Document mode:         OFF
  632.  Pagination:            OFF
  633.  Justification:         OFF
  634.  Line Spacing:          1
  635.  Page length:           66 lines
  636.  Text begins on:        6_
  637.  ends on:               60
  638.  Left margin:           1_ characters
  639.  
  640. You may wish to change some of the above, if you do then make sure that
  641. Pagination, Document mode and Line spacing are as above.
  642.  
  643. To use these settings, click on OK. You can now print out your text with
  644. single line spacing and no final form feed.
  645.  
  646.  
  647. VERSIONS OF DOS+ AND GEM AVAILABLE TO DATE.
  648.  
  649. 1.23 (Issue 1)  BIOS 1.00    Standard with boards under 5000
  650.  
  651. 1.23 (Issue 2)  BIOS 1.01    Standard with boards above 5000
  652.  
  653. 1.23 (Issue 2a) BIOS 1.02    Standard with Solidisk PC+ board
  654.  
  655. 2.13 (Issue 3 ) BIOS 1.03    Only available from Acorn as an upgrade, on
  656.                              return of original discs, and a cheque/po for
  657.                              £15.00
  658.  
  659. 2.13 (Issue 3 ) BIOS 1.03    As above but on 3 1/2" discs is available for
  660.                              £25.00 
  661.  
  662.  
  663. The charge on the upgrades is to cover post, packing, insurance and licence.
  664. We can accept cheque, postal order and Eurocheque. Please make cheques
  665. payable to Acorn Computers Ltd and put your address on the back of the
  666. cheque.
  667.  
  668. The address to return your order to is :
  669.  
  670.  CUSTOMER SUPPORT AND SERVICES
  671.  FULBOURN ROAD
  672.  CHERRY HINTON
  673.  CAMBRIDGE
  674.  CB1 4JN
  675.  
  676. BOOKS RELATING TO AND PROVIDING INFORMATION FOR THE MASTER 512.
  677.  
  678. BOOK TITLE                      AUTHOR    PUBLISHER            ISBN NUMBER
  679.  
  680. DOS+ User Guide                           Digital Research               
  681. DOS+ Programmers Reference Manual         Digital Research
  682. Using DOS+ on the Amstrad PC    S Morris  Glentop              1 85181 063 3
  683. Using GEM on the Amstrad PC     K Lang    Glentop              1 85181 065 X
  684. WP using GEMWrite               M O'Reilly 
  685.                                           Glentop              1 85181 067 6 
  686. DOS+ Manual for the Amstrad     D. R.     Glentop              1 85181 094 3  
  687. Dab Hand Guide to M512          C Snee    Dabs Press           1 870336 14 3  
  688. Dab Hand Reference Guide to M512        
  689.                                 R Burton  Dabs Press           Recommended 
  690. 80186 Data Sheet                          Intel UK Ltd 
  691. A & B Computing                           Argus Publ.          Monthly Mag.
  692. Mastering DOS+                  S Williams       
  693.                                           Sigma  
  694.  
  695.  
  696. EXTRA LEAFLETS AVAILABLE
  697.  
  698. Master 512 Technical Information
  699. Master 512 Circuit Diagram
  700. Master 512 GEM Mouse Driver Demo - for writing custom mouse drivers
  701. Edbin and Move User Guide
  702.  
  703.  
  704. ACORN ADD-ONS
  705.  
  706. DOS+ Econet, AES39, ` 149.00 - Allows full use of the Master 512 on Econet 
  707.  
  708.         Comes as a site licence. The software is loaded onto the fileserver
  709. and allows Master 512 users to access the Econet system, with the ability to
  710. load and save files, use the network printer, share files and programs,
  711. transfer files to and from PC's using Ecolink cards, etc.
  712.  
  713.  
  714.  
  715. THIRD PARTY ADD-ONS
  716.  
  717. Solidisk PC+ memory upgrade - Upgrades memory from 512k to 1024k
  718.  
  719.         Useful for big applications which require a lot of memory. Fits on
  720. top of 80186 co-processor. Issue 2 board well designed and built.
  721.  
  722. Marconi tracker ball - can be used in place of the mouse
  723. Margolis comm+ - the only comms package to work on the 512
  724. PSD keyboard modification - allows use of the num pad keys on a BBC B or B+ 
  725.  
  726.  
  727.  
  728. OPEN UNIVERSITY MICROCOMPUTER SPECIFICATION
  729.  
  730. The Master 512 does NOT meet the Open university specification for a micro
  731. computer for the following reasons:
  732.  
  733. Single disc drive   M512 requires twin disc drive for GEM
  734. CGA Graphics        CGA supported but only 2 colours
  735. Serial Port         Not supported properly
  736. Mouse               Only works under GEM
  737. Lotus 123 V2        Does not work
  738. UCSD Pascal         Does not work (used on M205 and M353)
  739. PC Automator        Un-tested
  740. Framework           All works except delete key
  741.  
  742.  
  743. USEFUL CONTACTS
  744.  
  745. FOR INFORMATION
  746.  
  747. Dabs Press, 5 Victoria Lane, Whitefield, Manchester, M25 6AL. Tel: 061 766
  748. 8423 
  749.  
  750. Glentop Publishers Ltd, Standfast House, Bath Place, Barnet, Herts, EN5 5XE 
  751.  
  752. Watford Electronics, Jessa House, 250 Lower High Street, Watford, WD1 2AN 
  753.  
  754. Digital Research, Oxford House, Oxford Street, Newbury, Berks, RG13 1JB 
  755.  
  756. Intel UK Ltd, Pipers Way, Swindon, Wilts, SN3 1RJ 
  757.  
  758. PSD, 20 Beechwood Rd, Easton-in-Gordano, Avon, BS20 0NA
  759.  
  760.  
  761. FOR REPAIRS
  762.  
  763. RCS, Headway House, Christy Estate, Ivy Rd, Aldershot, Hants, GU12 4TX. 
  764. Tel: 0252 333575 
  765.  
  766. Gosling Electronics, Hadleigh Rd, Ipswich, IP2 0ER. Tel: 0473 230075
  767.  
  768.  
  769. FOR ADD-ONS
  770.  
  771. Solidisk Technology Ltd, 17 Sweyne Ave, Southend-on-Sea, Essex, SS2 6JQ
  772.  
  773. Margolis & Co., 105 Founding Ct, Brunswick Centre, Marchmont St, London,
  774. WC1N 1AN 
  775.  
  776.  
  777. USER GROUP'S
  778.  
  779. The Big Ben DOS+ user group, c/o O.W.R. Van Dijk, Adm. de Ruyterweg 412 hs,
  780. 1055 ND Amsterdam, The Netherlands (the Big Ben DOS+ user group is part of
  781. the dutch Big Ben Club in the Netherlands) 
  782.  
  783. The Big Ben DOS+ user group are all very interested in the Master 512 and
  784. provide good support to their members. They have a very useful utility disc,
  785. which contains such things as a Num-Pad emulator for BBC B users. They are
  786. worth joining if you are seriously interested in the Master 512.
  787.  
  788.  
  789. NOTE: Some of the information in this leaflet has been provided by users of
  790. the Master 512, including the Dutch DOS+ user group, which is part of the
  791. Dutch Big Ben Club, and certain Acorn dealers. If you have any information
  792. that you would like me to add to this leaflet, which would benefit other
  793. users, or you have found problems with any of the listed packages; please
  794. write to the address on the front, giving as much detail as possible.
  795.  
  796.  
  797. SOFTWARE THAT SHOULD WORK ON THE MASTER 512 (ISSUE 10)
  798.  
  799. TITLE           VER.    SUPPLIER        COMMENT5
  800.  
  801. Ability         1.2     Migent          Except Comms & tutor
  802. Ability Plus            Migent          Except Comms & tutor
  803. Accountant      1.0     Sage            Some colour problems
  804. Accountant Plus 1.0     Sage            Some colour problems
  805. Auto sketch     1.0a    Auto Desk       Keyboard only
  806. Ballyhoo                Infocom
  807. BBC BASIC 86    1.0     M-Tec
  808. Beyond Zork     1.0     Infocom
  809. Book Keeper     1.0     Sage            Some colour problems
  810. Bureaucracy             Infocom
  811. Cardbox                 Business Simulations   
  812. Cardbox Plus            Business Simulations   
  813. Clipper 
  814. Dataease 2.5
  815. Dbase II 2.43           Ashton Tate
  816. Dbase III+      1.1     Ashton Tate
  817. Dbase IV        1.00    Ashton Tate     As far as tested
  818. Deadline                Infocom
  819. Delta           4.0
  820. Desktop         1.0     Sage            Some colour problems
  821. Displaywrite II 
  822. Displaywrite III                        Needs installing
  823. Draw-it         1.0
  824. DR C            1.0     Digital Research
  825. DR Fortran      1.0     Digital Research
  826. DR Pascal       1.0     Digital Research
  827. DR Personal BASIC       Digital Research
  828. DR RASM  1.0            Digital Research
  829. Easyflow
  830. Easywriter
  831. Enable
  832. Enchanter               Infocom
  833. Eureka          1.0     Borland
  834. Exchange        1.0     Psion           Needs installing on a PC first
  835. Executive Filer 1.0
  836. Executive Speller
  837.                 1.0
  838. Executive Writer 
  839.                 1.0
  840. Filing assistant
  841. Financial Control 
  842.                 1.0     Sage            Some colour problems
  843. Flight Simulator2.12    Microsoft       Not 2.13
  844. Fontasy         1.0    
  845. Framework II    1.0     Ashton Tate     Except scroll lock
  846. Freelance       
  847. GEM Desktop             Digital Research        Supplied
  848. GEM Diary       1.0     Digital Research
  849. GEM Draw        1.0     Digital Research
  850. GEM Graph       1.0     Digital Research
  851. GEM Paint               Digital Research        Supplied
  852. GEM Wordchart   1.0     Digital Research       
  853. GEM Wordcraft   1.0     Digital Research
  854. GEM Write       1.0     Digital Research        Supplied
  855. GW BASIC        1.0     Olivetti
  856. HAL
  857. Hitch Hikers Guide      Infocom
  858. IBM Assistant
  859. Infidel                 Infocom
  860. Integrated 7
  861. ITT XBASIC      
  862. Javlin
  863. Javlin Plus
  864. Kedit
  865. Lattice C       1.0    
  866. Leather Goddesses       Infocom
  867. Lets C  
  868. Level 2 Cobol   2.1
  869. Logistix        1.0     Grafox
  870. Lotus 123       1.0a    Lotus           Not 2.0. Latest version works
  871. Microsoft BASIC 2.0     Microsoft
  872. Microsoft C             Microsoft
  873. Microsoft Cobol  2.1    Microsoft
  874. Microsoft Fortran       Microsoft
  875. Microsoft MASM          Microsoft
  876. Microsoft Pascal        Microsoft
  877. Microtext
  878. MS-Chart        3.0     Microsoft      
  879. Multimate       3.2                     Except DEL key
  880. Multiplan       2.02           
  881. New Word 3      3.01    New Star        Files limited on DOS+ 1.2
  882. Norton Commander1.00    Peter Norton
  883. Norton Utilities Adv.   Peter Norton
  884. Paradox         2.0     Borland         Except personal programmer
  885. PC Boss         2.06
  886. Payroll         1.0     Sage            Some colour problems
  887. PC Calc
  888. PC File
  889. PC Four         1.0     Psion
  890. PC Outline      1.08           
  891. PC Paint        4.0
  892. PC Paintbrush
  893. PC Planner      1.0     Sage            Some colour problems
  894. PC Prolog       
  895. PC Promise      1.12
  896. PC Smart
  897. PC Storyboard   1.11                    Except camera
  898. PC Talk
  899. PC Tools
  900. PC Write        2.7
  901. PC Write        1.0     Sage            Some Colour Problems
  902. Pegasus Accounts        Pegasus
  903. Perfect Calc
  904. Perfect Filer
  905. Personal BASIC
  906. Personal Editor 1.0
  907. Planetfall              Infocom
  908. Power 'C'               MIX             Requires DOS+2.1 Reload COMMAND.COM first 
  909. Printmaster
  910. Quest
  911. Reflex
  912. Retrieve 1.0            Sage            Some colour problems
  913. Rogue
  914. Sidekick 1.2            Borland         Requires DOS+ 2.1 Not versions above 1.50
  915. Slidewriter+    
  916. Smartwork
  917. Sorceror                Infocom
  918. Stationfall             Infocom
  919. Storyboard      
  920. Supercalc II            Computer Associates
  921. Supercalc III   2.1     Computer Associates
  922. Supercalc IV    1.0     Computer Associates
  923. Suspect                 Infocom
  924. Suspended               Infocom
  925. Turbo C         1.0     Borland         Need to write your own Floating point routines
  926. Turbo CAD       1.0     Borland
  927. Turbo Editor    3.0     Borland
  928. Turbo Graphics          Borland
  929. Turbo Pascal    3.0     Borland
  930. Turbo Pascal    4.0     Borland         Requires DOS+2.1. Reload COMMAND.COM first 
  931. Turbo Reflex            Borland
  932. Twin            1.3
  933. Ventura Publisher        
  934.                 1.0                     Needs DOS+ 2.1 and PC+
  935. Volkswriter 3   1.0     Lifetree
  936. Volkswriter Deluxe      Lifetree
  937. VP Planner      1.0                     Requires loader
  938. VU Writer       
  939. VU Writer Scientific
  940. Wishbringer             Infocom
  941. Word perfect    4.2                     Not version 4.0 or 4.1
  942. Wordstar        3.x     Micro Pro
  943. Wordstar Prof.  4.0     Micro Pro       Requires DOS+ 2.1
  944. Zorland C                               Problems with ZC
  945. Zork I/II/III           Infocom
  946.  
  947.  
  948.  
  949. THIS INFORMATION IS SUBJECT TO CHANGE WITHOUT NOTICE. NO RESPONSIBILITY CAN
  950. BE TAKEN FOR ANY ERRORS OR OMISSIONS CONTAINED WITHIN THIS DOCUMENT, OR THE
  951. APPLICATIONS DESCRIBED. THE MASTER 512 IS NOT AN IBM CLONE SO NO
  952. RESPONSIBILITY CAN BE TAKEN FOR ANY APPLICATIONS WHICH DO NOT WORK IN
  953. ACCORDANCE WITH THEIR PUBLISHED INSTRUCTIONS. THE INFORMATION GIVEN IN THIS
  954. NOTE IS INTENDED TO PROVIDE A GUIDE TO APPLICATIONS THAT WILL WORK ON THE
  955. MASTER 512. THESE APPLICATIONS WORK AS FAR AS TESTED, BUT THESE ARE NOT
  956. EXHAUSTIVE TESTS. IT IS RECOMMENDED THAT AN APPLICATION IS TESTED TO YOUR
  957. REQUIREMENTS BEFORE BEING USED IN CONJUNCTION WITH THE MASTER 512, AS NO
  958. RESPONSIBILITY CAN BE TAKEN FOR APPLICATIONS LISTED THAT ARE FOUND NOT TO
  959. WORK FULLY WHEN RUN ON THE MASTER 512.
  960.  
  961.  
  962.  
  963. It is recognised that this document contains many trademarks, particularly
  964. International Business Machines (IBM, PC-DOS), Digital Research (DOS+, DR,
  965. GEM, CP/M 86), Microsoft Corp. (MS-DOS, MS-Mouse) and Borland (Sidekick).
  966. Acorn Computers acknowledge the existence of all the trademarks used in this
  967. document, and all the trademarks and trade names used in the software list.
  968.